home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 July / Chip_2000-07_cd.bin / sharewar / vbshpdfc / Install.exe / VB Shaped Form Creator.CAB / Readme.txt < prev    next >
Text File  |  2000-05-05  |  14KB  |  378 lines

  1. Readme for VB Shaped Form Creator (VBSFC) 11/2/99
  2. =================================================
  3.  
  4. Update:
  5. ~~~~~~~~~~~~~~~
  6.  
  7. Version 6 released.  This version includes a FormAnimator utility which can be
  8. used to produce animated shaped forms.
  9.  
  10. Other features added:
  11.  
  12.  A "Preview" feature which shows the background image clipped to the current
  13.  shape.  This makes it easy t osee what the form will look like when it is
  14.  generated.
  15.  
  16.  A "Copy as Bitmap" function which copies the current shape to the clipboard as
  17.  a bitmap, ready to be pasted into an image editing app to produce a background
  18.  image.
  19.  
  20. Extra Save Formats:
  21.  A binary Data File format.  This contains just the shape information, and is
  22.  therefore a smaller file than an entire generated form.  Example code for
  23.  reading data files is included, which should be a simple matter to translate
  24.  into other programming languages (which support the Windows API calls) to
  25.  produce shaped forms for them.
  26.  
  27.  A Delphi Form file format.  This produces Delphi .pas and .dfm files which can
  28.  be added to a delphi project.  The delphi code produced by this feature can be
  29.  considered Alpha test, as my Pascal skills are minimal to none.  Format is
  30.  Delphi 2, and subject to limitations: 
  31.     Cannot Modify Forms (sorry, I don't know enough Delphi format for this).
  32.     Cannot display form or control positions when opening a form.  Not
  33.      really a problem, considering the above limitation.
  34.     Does not perform any validation on form files opened.
  35.     Is not TwipsPerPixel aware.  I don't know how to do this without the Screen
  36.      object in VB, or even whether it is a problem for Delphi.  A "Scale"
  37.      property looked intersting, though...
  38.  
  39.  It does, however, size the form correctly, make it borderless, and allow full
  40.  window drag in the same way as as the VB generated forms.
  41.  
  42.  A C++ Source file format.  This produces C++ .cpp and .h files which can be
  43.  added to a C++ project to apply a shape to an existing window.  It does not
  44.  create a shaped window; it only produces the code which can then be used to
  45.  apply a shape to a window.  See the help file for a step by step guide on how
  46.  to use the code to give a window a shape.
  47.  
  48. Bug Fixes:
  49.  
  50.  If VBSFC is exited whilst in Edit Mode it will no longer start next time in
  51.  Edit Mode.
  52.  
  53.  Switching to the Numerical Editor will now hide the Zoom Window.
  54.  
  55.  Possible bug when displaying the Tip Of The Day window identified, and
  56.  workaround built in - a /NoTipWindow parameter switch has been added.
  57.  
  58. Update 29/8/99:
  59. ~~~~~~~~~~~~~~~
  60. Version 5.9 released.  This version fixes another couple of bugs and adds a new
  61. Edge Tracer method. This is more of a shape-fill rather than an edge-trace, as
  62. it fills the bitmap with rectangles to build up the shape, rather than outlining
  63. it with polygons (Thanks to Chad for the idea). This may be less efficient, but
  64. if a particular bitmap is proving troublesome for the other two methods, then
  65. select this option. (Find it by pressing the "Options" button in the Edge Tracer
  66. window).
  67.  
  68. Update 9/6/99:
  69. ~~~~~~~~~~~~~~
  70. Version 5.8 released.  This version adds a tip of the day, copy and pasting for
  71. shapes in the editor, and some minor bug fixes.  Also includes command line
  72. parameters, mostly for debugging.  If you are having trouble running VBSFC then
  73. try any combinations of the command line parameters /NoZoomWindow and
  74. /NoSubclassing.
  75.  
  76. Update 20/2/99:
  77. ~~~~~~~~~~~~~~~
  78. Version 5.6 released.  This version adds a floating zoom window.  It also allows
  79. you to drag and drop files onto the drawing area to open them.
  80.  
  81. Update 11/2/99:
  82. ~~~~~~~~~~~~~~
  83. Version 5.5 released.  The major change for this version is the new interface,
  84. but apart from that there have been many other minor changes:
  85.  
  86. Features Added:
  87. Shapes can be selected in the graphical editor by clicking on them.
  88. A Paste Background Bitmap command has been added.
  89. The Edge Tracer has a Clear Area command added.
  90. The Edge Tracer has also had a Paste Bitmap command added.
  91. The Edge Tracer is now a non-modal resizable minimizable whateverable window.
  92. An Add All button has been added to it.  And the interface completely redone.
  93. When opening a form an outline of it, and all the controls on it, is displayed.
  94. If you try to save over an existing file it will ask you if you want to modify it instead.
  95. Warnings are given before any action that would cause you to loose the current shape if not saved.
  96.  
  97. Improvements:
  98. The recently opened files history list no longer displays the full path, but a
  99.  shortened path, with the full path appearing in the status bar when the mouse is
  100.  over it.
  101. The grid runs about a million times faster (moved it into API drawing, rather than
  102.  
  103.  VB's incredibly slow line or point methods)
  104.  
  105. When resizing the form, the shape is now repainted (if you opened a form larger than
  106.  
  107.  the window, it will now be displayed if you enlarge the window)
  108.  
  109. What's This? help has been improved
  110.  
  111. More settings are saved (I can't remember which, but I think pretty much everything
  112.  
  113.  gets saved now...)
  114. In the Graphical editor, it is now possible to drag one side of an object past its
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  other side, as when drawing.
  123.  
  124. When the right mouse button is clicked (in TwoClick mode, not for Polygons) the
  125.  
  126.  
  127.  shape started is cancelled.
  128.  
  129. When in ClickDrag mode, if a size 0 shape is drawn (a click rather than a drag), it
  130.  
  131.  is ignored.
  132.  
  133.  
  134.  
  135. Bug Fixes:
  136.  
  137. Trying to save or modify a form when there is nothing to save no longer produces an
  138.  
  139.  error.
  140.  
  141. Cancelling a modify when prompted to replace exisiting information no longer produces
  142.  an error when next opening a file.
  143. Reset All Settings twice no longer produces an error.
  144. Other stuff :)  Probably anything that was wrong with it in previous versions isn't
  145.  now, but if it is, let me know and I will fix it.
  146.  
  147.  
  148. Update 10/12/98:
  149. ~~~~~~~~~~~~~~~~
  150. Version 4.0 released.  This is the first version to be compiled under
  151. Visual Basic version 6.  As such, it now requires the VB6 runtimes to run.
  152. The major change for this version is the addition of the Graphical Editor.
  153. This feature allows you to use the mouse to edit the shapes drawn, including
  154. adding, removing and moving polygon points.  For more information, see the
  155. Graphical Editor section of the help file.  Other changes include tooltips and
  156. What's This? help for all controls, an "Add All" command for the edge tracer
  157. (Shift+"Add"), and a couple of minor bug fixes.  The code produced has also
  158.  
  159. been modified.  The forms are now resizable (handling the resizing manually),
  160.  
  161. and the 64K limit VB imposes on functions is bypassed.  For more details, see
  162. the Code Produced section of the help file.
  163.  
  164. Please note, this is my first attempt with VB6, and although it has been in
  165. beta for a longer than usual time, to try and weed out all the bugs, it is
  166. always possible one slipped through.  If you email a bug report to me at the
  167. address given at the end of this docmuent, I will fix it and see to it you are
  168. informed of the fix when it is done.
  169.  
  170. Update 9/11/98:
  171. ~~~~~~~~~~~~~~~
  172. Version 3.1 released.  Fixes a bug with the file history list that could
  173. sometimes crash the program on exit.  Corrects spelling of Transparent
  174. (was transparant) throughout program and documentation.  Also adds command
  175. line handling, so files can be associated with it, or it can be placed on
  176. the send to menu, or have files dropped onto its executable, or shortcut
  177. to it.  Also adds scaling to the forms created so that if the user has a
  178. different Screen.TwipsPerPixel setting (i.e. if they have 'Large Fonts'
  179. turned on, or something similar), the shaped form is scaled too.  Please
  180. note that this will not automatically scale the background picture of a
  181. form (if any exists).  If you wish to do this, may I suggest you use some
  182. lines of code in the form load procedure similar to:
  183.  
  184.     Me.Show
  185.     Me.AutoRedraw = True
  186.     Me.PaintPicture Me.Picture, 0, 0, Me.ScaleWidth, Me.ScaleHeight
  187.     Me.AutoRedraw = False
  188.  
  189. (This is taken from Reversi, the sample program provided on the website.)
  190.  
  191. Update 31/10/98:
  192. ~~~~~~~~~~~~~~~~
  193. Version 3.0 released.  File New now clears background bitmap.  Modifying
  194. a form which already contains region information does not now duplicate
  195. declarations (unless they have been modified by the user).  A Recently
  196. Used Files list of the last 3 files opened or saved has been added to the
  197. File menu.  There is new edge tracing algorithm (the old one is still
  198. available as an option).  There is now an Auto try-again (optional) which
  199. searches for the best trace without requireing the user to press the Try
  200. Again button.  There is now also Grid and Snap support.
  201.  
  202. Update 24/9/98:
  203. ~~~~~~~~~~~~~~~
  204. Version 2.3 released, with Undo/Redo support and VB5 form creation.  Edge
  205.  
  206. Tracer command has been moved to the "Tools" menu.
  207.  
  208.  
  209. Update 3/9/98:
  210.  
  211.  
  212. ~~~~~~~~~~~~~~
  213.  
  214. Version 2.2 released, with improved Edge Tracing algorithm, which includes "Try
  215.  
  216. Again" button.
  217.  
  218.  
  219. Update 9/1/98:
  220.  
  221. ~~~~~~~~~~~~~~
  222.  
  223. Version 2 released, with Edge Tracing command.  See help file for details.
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242. Disclaimer:
  243.  
  244. ~~~~~~~~~~~
  245.  
  246.  
  247. This software is provided on an "as is" basis.  Nothing should go wrong,
  248.  
  249. but if it does, it is not my fault.  You use this software at your own risk.
  250.  
  251. License:
  252.  
  253. ~~~~~~~~
  254.  
  255. This program is licensed for non-commercial use only.  If you intend to sell
  256.  
  257. your program, I think it is only fair you pay for mine (only 20$).  See
  258. "Registration" in the help file for details on how to register online or by
  259.  
  260. mail.
  261.  
  262.  
  263.  
  264. Installation:
  265.  
  266. ~~~~~~~~~~~~~
  267.  
  268.  
  269.  
  270. Ignore this section if you downloaded one of the installer programs.
  271.  
  272.  
  273. After you have downloaded VBSFC.zip, extract all the contents into the
  274. folder where you want it installed, for exampe "c:\program files\accessories
  275. \Visual Basic Shaped Form Creator\".  There should be 4 files; this one
  276.  
  277. (Readme.txt), the main executable (VB Shaped Form Creator.exe), the help
  278. file (VBSFC.hlp) and the help contents (VBSFC.cnt).
  279.  
  280. This program requires the VB6 runtimes (vbrun60.exe) and the
  281. two common control ocx's ComCtl32.ocx and ComDlg32.ocx.
  282.  
  283. If you are missing any of these files they can be downloaded from the my
  284. website at http://www.comports.com/AlexV/VBSFC.html
  285.  
  286. Uninstallation:
  287. ~~~~~~~~~~~~~~~
  288.  
  289. If you have installed VBSFC using the installer, use the Add/Remove programs
  290. icon in the control panel, and select VB Shaped Form Creator.  Otherwise, or
  291. if this item does not appear, then run VBSFC and choose "Remove All Settings"
  292.  
  293.  
  294.  
  295. from the "Help" menu.  This will remove all the programs registry entries.
  296.  
  297. You can then delete all the files you installed.
  298.  
  299. WalkThrough 10 step easyguide thingy.
  300. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  301.  
  302. This was requested, so I am putting it in.  90% of you won't need this, so
  303. don't bother reading it if you don't.
  304.  
  305. 10 steps to a Shaped Hello World example
  306. ========================================
  307.  
  308. 1:  Load VB Shaped form creator.
  309. 2:  Draw your shape.  For example, stick an oval so that it just touches the top and left of the drawing area.  You can put it elsewhere if you want, but it is only wasting space.
  310. 3:  Save it as a form.  Put it somewhere you will remember.
  311. (optional step --
  312. 3b:  Export it as a bitmap.  Put it in the same place as the form
  313. --)
  314. 4:  Load VB.  You should start with a blank project.
  315. 5:  Remove the Form1 file (as we will not use it)
  316. 6:  Add a file to the project.  In VB4 this is done by right clicking on the project box and choosing "Add File".  Select the form you saved in step 3.
  317. 7:  Show the form (if not shown already)
  318. (optional step --
  319. 7b:  Set the form's "picture" property to the picture you exported in step 3b.  This gives you
  320. a guideline as to what bits of the form are displayed when it is run.
  321. --)
  322. 8:  Put a label control and a button contol on the form.  Change the label caption to nothing, and the button caption to "Press Me" (or similar).  If you have done the optional steps, then you can make sure that both controls are within the coloured area (red by default), then remove the form's picture (as we don't need it any more).
  323. 9:  Double click the "Press Me" button to set code.  Type into the sub the line:   label1.caption = "Hello World"
  324. 10:  Run the project.  You will be told that you have not specified a startup form, and asked to do so.  Specify the "ShapedForm" form, and run the project.
  325.  
  326.  
  327.  
  328. Edge Tracer Issues:
  329. ~~~~~~~~~~~~~~~~~~~
  330. The new algorithm (default) corrects some issues with the old one.  The old
  331. algorithm was reported to produce a trace which would not cover the last
  332. line and row of pixels on the right and at the bottom, so for example an
  333. triangle with a 1 pixel wide outline would show the outline of only one side
  334. once traced.  The new algorithm corrects this fault, but again, it is not
  335. perfect.  With the new algorithm sometimes one or two background pixels find
  336. their way into being included in the traced area.  This is not usually a
  337.  
  338.  
  339. problem, but I have included the old algorithm as an option just in case.
  340.  
  341.  
  342.  
  343. ------------------------------------------------------------------------------
  344.  
  345.  
  346.  
  347. Thank you for reading this document.
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354. Email the author at:                 AlexV@ComPorts.com
  355.  
  356. VB Shaped Form Creator website:        www.ComPorts.com/AlexV/VBSFC.html
  357.  
  358. Other programs by the same author:    www.ComPorts.com/AlexV
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.